package com.cr.business.mapper;

import java.util.List;
import com.cr.business.domain.TbQualifiedCertInfo;
import com.cr.business.domain.dto.QualifiedCertReqDto;
import com.cr.business.domain.dto.app.QualifiedCertListParam;
import com.cr.business.domain.vo.AppCertListData;
import com.cr.business.domain.vo.QualifiedCertDataVo;
import com.cr.business.domain.vo.QualifiedCertDetailInfoVo;
import org.apache.ibatis.annotations.Param;

/**
 * 合格证信息Mapper接口
 * 
 * @author tang
 * @date 2025-08-19
 */
public interface TbQualifiedCertInfoMapper 
{
    /**
     * 查询合格证信息
     * 
     * @param certId 合格证信息主键
     * @return 合格证信息
     */
    QualifiedCertDetailInfoVo selectTbQualifiedCertInfoByCertId(String certId);

    TbQualifiedCertInfo selectBaseInfoByCertId(String certId);
    /**
     * 查询合格证信息列表
     * 
     * @param dto 参数
     * @return 合格证信息集合
     */
    List<QualifiedCertDataVo> selectTbQualifiedCertInfoList(QualifiedCertReqDto dto);

    /**
     * 新增合格证信息
     * 
     * @param tbQualifiedCertInfo 合格证信息
     * @return 结果
     */
    int insertTbQualifiedCertInfo(TbQualifiedCertInfo tbQualifiedCertInfo);

    /**
     * 修改合格证信息
     * 
     * @param tbQualifiedCertInfo 合格证信息
     * @return 结果
     */
    int updateTbQualifiedCertInfo(TbQualifiedCertInfo tbQualifiedCertInfo);

    /**
     * 删除合格证信息
     * 
     * @param certId 合格证信息主键
     * @return 结果
     */
    int deleteTbQualifiedCertInfoByCertId(String certId);

    /**
     * 批量删除合格证信息
     * 
     * @param certIds 需要删除的数据主键集合
     * @return 结果
     */
    int deleteTbQualifiedCertInfoByCertIds(String[] certIds);

    /**
     * 小程序端合格证列表数据
     * @param param 查询参数
     */
    List<AppCertListData> selectAppCertListData(QualifiedCertListParam param);

    /**
     * 根据ID获取列表数据
     */
    List<AppCertListData> selectPrintCertList(@Param("idArr") String[] idArr);

    /**
     * 获取合格证打印数量
     * @param userId 用户ID
     */
    int getSumPrintQuantity(String userId);

    /**
     * 开具总数量
     */
    int selectAllCount();

    /**
     * 今日开具数量
     */
    int selectTodayCount();
}
